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Abstract 


DP  is  a  highly  interactive  graphics  editor  that  runs  on  a  personal  workstation  and  can  produce  general* 
purpose  illuviations  as  well  as  circuit  drawings.  The  main  purpose  of  this  document,  which  is  a  complete 
specification  of  the  format  and  semantics  of  DP  drawing  files,  is  to  encourage  the  development  of  application 
programs  that  can  read  and  generate  drawings  in  the  DP  format  and  thus  exchange  information  in  graphics 
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1 .  Introduction 

DP  is  an  interactive  graphics  editor  that  can  produce  arbitrarily  complex  drawings  and  runs  on  a  scientific 
personal  computer,  Perq  System  Corporation’s  PI'RQ  workstation  (see  Giusc's  DP  ■  Command  Set  131  for  a 
general  description  of  the  program).  DP  deals  with  graphics  objects  such  as  lines,  strings  of  text,  circles,  etc., 
as  opposed  to  being  purely  bitmap-oriented.  All  the  information  entered  by  the  user  is  preserved  in  the 
drawing;  this  makes  it  possible,  for  instance,  for  a  program  to  analyze  a  drawing  and  to  extract  from  it 
graphical  and  semantical  information. 

As  an  example  of  information  extraction,  DP  drawing  files  can  be  fed  into  a  set  of  post-processors  that  extract 
circuit  information  from  drawings  (see  Giusc  for  a  description  of  two  such  post-processors  [9]  [71). 
Application  programs  arc  free  to  assign  their  own  semantic  interpretation  to  any  drawing;  DP  only  deals  with 
the  syntactic  rules  that  determine  the  appearance  of  graphic  items  in  a  drawing. 

DP  drawings  are  stored  on  secondary  memory  as  files,  where  each  file  corresponds  to  one  drawing.  This 
document  describes  the  format  of  drawing  files  as  generated  by  DP  version  6.10;  please  contact  the  author  if 
you  arc  running  a  different  version  of  the  program. 


The  main  objectives  in  the  design  of  the  DP  file  format  and  the  technical  reasons  behind  some  of  the 
decisions  arc  described  in  section  2.  Portability,  completeness,  and  the  ability  to  input  drawing  files  in  one 
pass  were  the  primary  considerations  that  influenced  the  design. 

The  primitive  graphics  elements  used  in  DP  drawing  files  and  the  symbol  mechanism,  which  allows  drawings 
to  contain  hierarchical  structures  that  can  be  nested  arbitrarily,  are  described  in  section  3. 

The  remaining  sections  of  the  document  describe  the  coordinate  system,  the  general  structure  of  drawing  files, 
and  the  detailed  syntax  and  semantics  of  each  DP  graphics  item  as  represented  in  drawing  files. 

Section  12  contains  the  formal  description  of  the  syntax  of  DP  files.  This  description  uses  an  extended  BNF 
grammar. 


Finally,  presented  in  section  13  is  an  example  of  a  simple  drawing  and  the  complete  listing  of  the 
corresponding  DP  drawing  file,  illustrating  some  of  the  more  important  points  of  the  format. 


2.  Main  Objectives  of  the  File  Definition 


The  design  of  lhc  format  of  l)P  files  evolved  from  a  few  objectives  that  were  considered  essential.  These 
objectives  were  ollcn  dictated  by  observations  and  experience  with  previous  drawing  programs  (SUDS  [8], 
Draw  [4],  Markup  [5|,  and  SIL|6]>.  Most  of  these  programs  ran  on  the  Alto,  an  early  bit-mapped  personal 
workstation  developed  by  the  XHROX  Palo  Alto  Research  Center. 

The  main  objectives  can  be  summarized  as  follows: 

•  Portability:  drawing  files  should  be  portable  to  different  machines  and  to  different  operating 
systems.  It  should  be  easy  to  read  or  generate  drawings  using  different  programming  languages: 
the  representation  of  a  drawing  should  be  independent  of  the  particular  program  that  generated  it. 

•  Completeness:  drawing  files  should  be  completely  self-contained  and  should  not  depend  on  any 
external  library.  A  single  file  should  correspond  to  a  single  drawing;  the  file  should  not  have  any 
external  dependency. 

•  Simplicity:  drawing  files  should  be  simple  to  interpret  and  should  have  a  direct  correspondence  to 
the  graphics  operations  they  describe.  It  should  be  possible  for  a  program  to  read  a  drawing  file  in 
just  one  pass,  without  the  need  for  elaborate  multiple-pass  operations  that  may  be  time- 
consuming  and  difficult  to  implement 

•  Separation  of  concerns:  drawing  files  should  be  a  purely  graphical  description,  without  any 
embedded  semantic  knowledge  about  what  the  drawing  represents.  ITic  interpretation  of  a 
drawing  should  be  left  to  the  user  and  to  appropriate  application  programs;  this  achieves  complete 
separation  between  the  "meaning”  of  a  drawing  and  its  graphical  appearance,  thus  increasing  the 
overall  flexibility  of  the  system. 

2.1  Portability 

The  main  mechanism  to  achieve  portability  of  drawing  files  is  the  choice  of  using  exclusively  ASCII 
characters  in  the  format.  The  requirement  that  DP  files  be  text  files  was  considered  very  important  and  was 
central  to  the  development  of  a  large  number  of  application  programs  that  can  read  and  generate  DP  files.  It 
was  clear  that  this  choice  would  cause  files  to  be  somewhat  larger  than  binary  files,  and  that  the  time  required 
to  parse  a  file  would  also  be  longer.  On  the  other  hand,  a  number  of  reasons  that  justified  the  choice  of  text 
files  exist;  those  reasons  arc  briefly  presented  here. 

A  purely  ASCII-based  file  format  makes  it  easy  to  transfer  and  store  files  to  different  machines.  Format 
changes  between  successive  versions  arc  easier  than  in  the  case  of  binary'  files.  ASCII  files  are  completely 
machine  independent,  while  binary  files  may  embed  assumptions  about  machine  word  size  or  number 
representations  that  may  be  difficult  to  eradicate. 

ASCII  files  are  typically  easier  for  a  program  to  read,  no  matter  what  language  the  program  is  implemented 
in.  Several  programs  have  been  written  that  generate  simple  drawings;1  DP  files  can  be  created  using 

Vor  instance,  the  program  that  generates  the  image  of  chips  on  a  board  described  in  Giuse  [9]. 


standard  I/O  statements  available  in  most  programming  languages,  without  any  knowledge  of  the  internal 
representation  of  graphics  objects. 

Finally,  as  a  side-effect,  OP  files  may  be  edited  using  standard  text  editors.  While  this  is  not  a  recommended 
procedure,  it  has  proven  useful  in  a  few  eases  where  a  simple  text  substitution  in  a  very  large  file  could  for 
instance  change  the  name  of  a  symbol.  Moreover,  this  procedure  can  be  used  to  salvage  drawings  that  were 
damaged  due  to  file  system  errors. 

The  fact  that  OP  files  arc  pure  text  files  was  one  of  the  main  reasons  that  made  it  possible  to  interface  OP  to 
Mint,  the  Spice  document  preparation  system,  in  less  than  two  days.  'ITie  task  would  undoubtedly  have  been 
much  harder  if  binary  files  had  been  used. 

As  a  side  remark,  a  comparison  with  SUOS  [8]  drawings  files  (which  arc  binary  files)  showed  that  OP  files  arc 
actually  45%  smaller  than  SUOS  files,  in  spite  of  the  fact  that  they  arc  entirely  ASCII-based.  This  is  because 
the  representation  used  by  SUOS  is  extremely  bulky;  a  careful  choice  of  representation  would  of  course  result 
in  a  binary  file  being  shorter  than  the  corresponding  text  file. 

2.2  One-pass  Scanning 

It  was  considered  essential  for  the  file  format  to  support  one-pass  scanning:  it  should  be  possible  to  read  a 
drawing  in  just  one  pass  through  the  file,  and  no  information  should  be  used  before  being  defined.  For  an 
example  of  another  format  that  supports  single-pass  reading,  see  the  description  of  the  CIF  format  in  [2]. 

The  main  device  to  achieve  one-pass  scanning  is  die  ordering  of  symbol  definitions.  Symbol  definitions  are 
always  output  before  any  of  the  correspondent  symbol  calls;  moreover,  symbol  definitions  cannot  contain 
other  symbol  definitions.  Each  definition  appears  at  the  top  level  in  the  file,  and  all  the  symbols  that  are  used 
inside  other  symbols  are  always  output  first 

This  convention  requires  more  work  to  generate  a  file,  but  it  makes  reading  the  file  much  faster.  Since  a  file 
may  be  read  several  times  but  is  only  written  once,  it  was  decided  to  favor  reading  at  the  expense  of  longer 
writing  times.  In  the  case  of  DP,  for  instance,  the  measured  overhead  for  generating  files  in  this  order  is  less 
than  15  percent  of  the  total  time  to  write  a  file;  this  is  certainly  an  acceptable  overhead,  given  the  significant 
savings  in  reading  time. 

2.3  Files  as  Independent  Entities 

Some  drawing  systems  (see,  for  instance,  (8])  allow  drawings  that  are  composed  of  multiple  files,  or  drawings 
that  contain  embedded  references  to  external  libraries.  The  rationale  is  to  reduce  the  size  of  drawing  files  by 
sharing  common  definitions  among  many  drawings.  Drawings  that  contain  references  to  external  files, 
however,  present  two  important  problems: 

•  Transferring  a  drawing  to  a  different  machine  may  be  difficult,  since  all  the  imported  files 
(including  possibly  files  that  arc  imported  indirectly)  should  also  be  transferred. 

•  Modifications  to  a  file  may  have  totally  unpredictable  effects  on  drawings  that  import  it.  This  is 
especially  dangerous  in  the  case  of  library  files,  i.e.,  files  that  contain  collections  of  commonly 
used  symbols  and  definitions. 


It  was  thus  decided  that  1)1*  drawings  should  he  totally  self-contained  entities:  no  reference  to  external  files  is 
allowed.  This  makes  it  extremely  easy  to  transfer  a  drawing  to  a  different  machine. 

Totally  self-contained  drawings  must  contain  the  definitions  for  all  the  symbols  they  use;  this  results  in 
somewhat  larger  files,  since  commonly  used  definitions  may  have  to  be  duplicated  in  several  files.  It  was  felt, 
however,  that  this  would  not  constitute  an  important  problem  and  that  the  advantages  far  outweighed  die 
possible  drawbacks. 

It  may  seem  that  self-contained  drawings  make  die  problem  of  change  propagation  worse,  since  the  only  way 
to  change  a  commonly  used  definition  is  to  change  all  the  drawings  diat  use  it.  It  should  be  noted,  however, 
that  external  references  do  not  address  the  problem  of  change  propagation  in  a  multi-machine  environment 
anyway,  and  diis  is  by  far  the  most  severe  aspect  of  the  problem.  It  is  probably  safer  to  let  the  user  worry 
about  change  propagation  explicitly:  for  instance,  a  program2  has  been  written  that  changes  the  definition  of 
one  or  more  symbols  in  a  set  of  DP  files,  lhis  approach  allows  selective  propagation  of  changes  to  some  of  the 
files,  as  opposed  to  the  common-library  approach  which  affects  all  the  drawings  that  use  a  library  symbol. 


ie  program  is  named  NewSymboL 


3.  Graphic  Elements  in  DP  Drawings 


Only  a  limited  set  of  basic  elements  can  appear  in  drawing  files:  such  elements  arc  used  to  create  more 
complex  drawings.  All  the  basic  elements  represent  a  geometric  concept  (a  line,  a  circle,  and  so  on);  each 
drawing  is  thought  of  as  a  collection  of  geometric  elements. 

DP  docs  not  use  bitmaps  as  representations  for  objects:  it  is  impossible,  for  instance,  to  describe  a  curve  by 
tracing  it  on  the  screen  with  the  cursor.  Smooth  curves  arc  defined  geometrically,  in  terms  of  control  points. 
Kxtensive  use  of  geometric  representations  makes  1)P  drawings  independent  of  the  particular  characteristics 
of  the  device  die  drawing  was  created  on. 


3.1  Primitive  Graphic  Elements 

The  primitive  elements  used  by  DP  arc 

•  lines:  finite-length  straight  line  segments, 

•  circles  and  arcs:  full  circles  or  arcs  of  circles, 

•  ellipses:  full  ellipses  or  arcs  of  ellipses, 

•  splines:  3rd  order  13-splines,  i.e.,  parametric  curves  that  interpolate  a  set  of  points, 

•  polygons:  filled  polygons  identified  by  a  set  of  vertices  and  a  filling  pattern, 

•  text  strings:  sequences  of  printing  ASCII  characters  in  a  given  font,  and 

•  pins:  used  inside  symbol  definitions  to  provide  connection  points.  Each  pin  has  a  pin  number 
associated  with  it. 


3.2  Symbols 

Primitive  elements  may  be  composed  through  the  Symbol  mechanism.  When  a  set  of  objects  is  made  into  a 
symbol,  the  latter  becomes  equivalent  to  a  primitive  element.  All  the  operations  that  apply  to  primitive 
elements  apply  to  symbols  as  well;  in  particular,  symbols  may  be  nested  inside  other  symbols. 

The  following  two  mechanisms  arc  provided: 

•  definition  of  a  symbol:  definition  of  a  group  of  elements  that  determine  the  shape  of  the  symbol. 

A  definition  in  itself  docs  not  add  any  element  to  a  drawing:  it  simply  defines  how  to  draw  a 
group  of  elements  if  required.  A  definition  can  be  considered  as  a  template  that  describes  how  to 
draw  a  picture. 

•  instance  of  a  symbol:  creation  of  a  copy  of  a  symbol  in  a  drawing:  each  instance  defines  the 
global  offset  and  the  transformation  parameters.  Creating  an  instance  is  equivalent  to  adding  to 
the  drawing  the  whole  set  of  elements  that  form  the  symbol;  if  transformations  are  used,  the 
elements  may  appear  rotated  or  scaled. 
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4.  Description  of  the  Format 

Please  note  that  in  the  rest  of  the  document  the  phrases  "the  Reader"  and  "the  DP  Reader"  will  be  used  to 
indicate  the  portion  of  code  in  DP  dial  reads  drawing  files  and  converts  them  into  graphic  items. 

4.1  Coordinate  System 

DP  files  use  a  Cartesian  coordinate  system:  abscissas  increase  to  the  right,  and  ordinates  increase  to  the  top. 
All  coordinates  arc  expressed  as  pairs  of  integers  in  base  ID.  in  die  range  -32767  through  32767:  the  origin  is  at 
the  point  (0, 0).  For  consistency,  numbers  other  than  coordinates  arc  also  expressed  as  decimal  integers.3 

Angles  arc  always  measured  in  minutes  of  arc,  starting  from  0  for  the  positive  X  direction  and  growing 
counter-clockwise.  For  instance,  an  angle  of  90  degrees  (corresponding  to  die  north)  is  expressed  as  90*60  = 
5400  minutes:  south  is  expressed  as  270*60  =  16200  minutes.  The  valid  range  for  an  angle  is  [0..21600],  with 
the  first  and  last  values  representing  the  same  angle.  Angles  outside  the  range  arc  always  normalized  by 
adding  or  subtracting  21600. 

4.2  Bounding  Boxes 

The  bounding  box  of  an  object  is  defined  as  the  smallest  rectangle  that  completely  encloses  the  object.  The 
edges  of  the  rectangle  are  parallel  to  the  cartesian  axes. 

The  bounding  box  of  an  instance  is  always  computed  after  the  necessary  transformations  have  been  applied; 
for  this  reason,  the  dimensions  of  the  box  may  not  coincide  with  the  size  of  the  symbol  definition. 

4.3  General  Format 

In  general,  a  text  line  in  a  DP  file  describes  one  graphic  element;  some  lines  are  used  differently,  for  instance 
as  comments  or  as  non-graphical  information.  Lines  are  terminated  by  the  normal  end-of-line  convention, 
and  different  fields  of  a  line  are  separated  by  one  blank. 

The  first  character  in  a  line  determines  what  kind  of  object  the  line  represents.  The  first  character  of  a  line 
may  be  one  of  the  following: 

•  Capital  letter:  the  line  describes  a  basic  element  or  a  symbol  definition. 

•  Semicolon:  the  line  is  a  comment 

•  @:  the  line  contains  special  non-graphical  information. 

The  interpretation  of  individual  fields  depends  on  the  particular  kind  of  item  and  is  explained  in  the 
following  sections. 

In  order  to  identify  DP  files  as  such,  a  special  convention  is  used:  the  first  line  of  the  file  must  be  a  comment 

of  the  form 

3With  the  exception  of  trai  ^formation  parameters  for  symbol  instances,  which  are  floating-point  numbers. 


;  DP  ver.  8.9 

The  DP  Reader  requires  this  line  at  the  beginning,  and  will  abort  the  Read  operation  if'  the  first  characters  do 
not  match  exactly  the  string  DP  ver.".  This  line  has  the  double  function  of  rejecting  non-DP  files  and 
informing  DP  of  what  version  of  the  program  created  the  file:4  all  the  characters  after  the  first  ten  arc 
considered  part  of  die  version  number. 

Fxccpt  for  this  special  convention,  comment  lines  may  appear  anywhere  in  the  file. 

4.4  Structure  of  a  DP  File 

Hie  following  order  is  used  in  all  DP  files.  Since  the  DP  Reader  depends  on  this  particular  order  in  a  few 
places,  files  that  do  not  follow  this  order  arc  considered  illegal. 

•  Version  number:  the  special  comment  line  mentioned  above. 

•  Time  stamp:  an  optional  comment  line  with  the  date  and  time  of  creation  of  the  file. 

•  Tree  structure:  an  optional  set  of  comments  that  describe  die  tree  of  symbol  definitions  and 
specify  dependencies  on  other  symbols.  This  information  is  only  used  by  the  "i"  (Read  Symbol 
From  File)  command. 

•  Font  information:  definition  of  all  the  fonts  used  in  the  drawing.  This  section  is  absent  if  no 
strings  are  used. 

•  Layer  information:  definition  of  all  the  layer;  that  constitute  the  drawing. 

•  Marks  information:  list  of  all  the  special  position  markers  in  the  drawing.  This  section  is  absent  if 
no  mark  is  used. 

•  Grids  information:  list  of  mouse  and  display  grids  used  when  creating  the  drawing. 

•  Symbol  definitions:  list  of  all  the  symbol  definitions  used  within  other  symbols  and  at  the  top 
level.  The  definitions  arc  ordered  so  that  lower-level  definitions  precede  higher-level  definitions: 
a  symbol  is  always  defined  before  it  is  used.  This  section  is  absent  if  die  drawing  is  "flat",  i.c.,  it 
contains  no  symbols. 

•  Top-level  items:  all  the  objects  (primitive  graphics  elements  and  symbol  instances)  that  appear  at 
the  top  level  in  the  drawing,  i.e.,  are  not  nested  inside  symbols. 
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Some  details  of  the  format  are  different  in  previous  versions,  and  the  DP  Reader  must  deal  with  the  differences. 


5.  Tree  Structure 


Hie  purpose  of  this  section  is  to  describe  dependencies  among  symbols.  This  information  is  used  only  when  a 
single  symbol  is  read  from  a  file  by  the  Reader.  Application  programs  are  free  to  ignore  this  section 
altogether;  all  the  lines  in  the  section  arc  preceded  by  a  semicolon  and  as  such  they  may  be  considered  as 
comments. 

The  special  command  that  reads  one  symbol  from  a  DP  file  uses  this  information  to  avoid  multiple  passes 
over  the  file.  When  a  symbol  is  read,  all  the  nested  symbols  must  be  read  as  well;  this  procedure  is  potentially 
recursive,  since  it  is  impossible  to  know  what  symbols  arc  needed  before  reaching  die  top-level  definition. 
The  Tree  Structure  provides  die  Reader  with  this  information:  in  particular,  each  symbol  is  listed  with  the 
transitive  closure  of  all  die  symbols  it  uses.  This  information  is  precomputed  when  the  file  is  first  created,  so 
that  ciich  symbol  contains  the  names  of  all  the  symbols  it  uses  cidicr  directly  or  indirectly. 

During  the  "Input  One  Symbol"  command,  die  DP  Reader  simply  scans  the  file  and  enters  the  symbols  that 
were  listed  in  the  Tree  Structure  as  used  by  the  required  symbol.  Everything  else  is  discarded;  the  Reader 
stops  alter  the  required  symbol  has  been  read. 


5.1  Format 

For  each  symbol  definition  two  comment  lines  arc  used  in  the  Tree  Structure  section: 

•  ;SYMBOL:  SymbolName 

•  ;CALLS:  list  of  all  the  nested  symbols,  separated  by  blanks 

All  the  symbols  have  an  entry  in  the  Tree  Structure  entry.  Leaves  of  the  tree,  i.e.,  symbols  that  are  entirely 
composed  of  primitive  elements,  have  an  empty  ’;CALLS:  ’  field. 


5.2  Example 

Imagine  a  drawing  that  contains  symbol  TOP,  which  imports  the  two  other  symbols  SYMBOL1  and 
SYMBOL2;  imagine  also  that  both  SYMBOL1  and  SYMBOL2  import  symbol  LEAF.  The  Tree  Structure 
section  of  the  drawing  would  then  look  like  this: 

; SYMBOL:  TOP 

; CALLS:  SYMBOL 1  SYM80L2  LEAF 
; SYMBOL:  SYMBOL 1 
; CALLS:  LEAF 
; SYMBOL:  LEAF 
; CALLS: 

; SYMBOL:  SYMB0L2 
; CALLS:  LEAF 


J-.V-V.V. 


Xj-V'wV- 
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6.  Font  Information 

This  section  of  the  file  describes  the  fonts  used  by  die  strings  in  die  drawing.  The  main  purpose  of  the  section 
is  to  define  local  font  numbers,  i.c.,  numbers  dial  uniquely  identify  a  particular  font.  This  is  the  only  place  in 
a  file  where  font  name,  size,  etc.,  arc  explicitly  mentioned;  all  further  references  arc  through  die  unique  local 
font  number. 

Local  font  numbers  arc  only  meaningful  within  one  file;  the  same  font  entry  may  well  have  a  different  local 
font  number  in  a  different  file.  Whenever  the  file  is  read,  the  DP  Reader  automatically  converts  the  local  font 
number  into  a  global  font  specification. 

A  font  entry  specifics  two  distinct  pieces  of  information:  the  abstract  font  specification  (c.g.  TimesRoman  12 
boldface)  and  the  name  of  a  Perq  font  used  to  display  that  font  on  the  Perq  screen.  Giuse  [3]  and  Sproull  [1] 
give  more  details  on  font  specifications.  Two  lines  arc  used  for  each  font  entry:  the  first  line  contains  the 
abstract  font  specification,  the  second  line  identifies  the  Perq  font  file. 

The  format  of  the  first  line  (abstract  font  definition)  is  die  following: 

Sfont  FontNumber  Face  Size  Rotation  Family 

FontNumber:  a  small  positive  integer  that  uniquely  identifies  this  font.  This  number  will  be  used  in  all 

the  strings  that  use  this  font,  and  is  meaningless  outside  the  file.  Local  font  numbers  are 
unique,  but  diey  are  not  guaranteed  to  be  contiguous  or  monotonieally  increasing. 

Face:  one  or  two  lower-case  characters  that  identify  the  font  face  (see  Giuse  [3]  for  more  details). 

The  characters  {r  b  i}  arc  currently  used  Co  indicate  Roman,  Boldface,  and  Italics. 
Characters  may  be  combined  when  this  is  meaningful  (for  instance,  bi  stands  for  boldface 
italics). 

Size:  a  positive  integer  that  specifics  the  size  of  the  font  (in  points).  Big  numbers  indicate  large 

fonts;  sec  Sproull  [1|  for  more  details. 

Rotation:  the  font  rotation,  in  minutes  of  an  arc  (see  section  4.1);  normally  0. 

Family:  the  name  of  the  font  family  (e.g.,  "Bodoni”  or  "NcwHelvctica").  Case  distinctions  in  the 

family  name  are  ignored,  i.e.,  "Gacha"  and  "GACHA"  arc  equivalent 


The  format  of  the  second  line  (Perq  font)  is  the  following: 
Sperqfont  FontNumber  FileName 


FontNumber: 


FileName: 


must  match  one  of  die  local  font  numbers  that  appear  in  a  ©font  statement.  Note  that  in 
files  generated  by  DP  this  line  follows  immediately  the  corresponding  ©font  line,  and  the 
FontNumber  is  dius  redundant. 

the  file  name  of  a  valid  Perq  font.  The  font  must  be  present  on  the  Perq  disk  when  this  line 
is  read;  if  this  is  not  the  case,  the  Reader  prompts  the  user  for  an  alternative  file  name. 
Note  that  including  absolute  path  names  in  this  file  name  is  likely  to  impair  the  portability 
of  the  DP  file  and  should  be  avoided. 
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7.  Layers  Information 

'lliis  section  defines  the  layers  used  in  the  drawing  and  specifics  die  value  of  the  parameters  for  each  layer  (see 
Giusc  13]  for  more  details  on  layers).  Note  that  if  a  layer  name  is  already  in  use  before  the  file  is  read,  old  and 
new  layer  arc  merged  and  old  and  new  items  appear  on  one  layer.  In  other  words,  layer  names  are  global  to 
all  DP  files;  it  is  impossible  to  define  two  different  layers  with  the  same  name. 

In  the  ease  of  symbol  instances,  layers  act  as  filters.  Imagine  for  example  that  a  symbol  on  layer  A  contains 
items  that  arc  on  layer  B:  if  both  layers  A  and  B  arc  visible,  the  items  will  be  displayed.  If  layer  A  is  made 
invisible,  though,  die  items  will  not  be  displayed  even  if  their  own  layer  (B)  is  still  visible.  Since  the  symbol  at 
the  upper  level  is  invisible,  none  of  the  objects  inside  it  arc  visible:  layer  A  is  "filtering"  all  the  items 
contained  in  symbols  that  appear  on  it. 

Each  line  in  the  Layers  Information  section  defines  one  layer.  The  format  of  each  line  is  the  following: 

Slayer  l, ay erN umber  Name  Options 

LayerNumber:  a  small  positive  integer  that  uniquely  identifies  this  layer.  This  number  will  be  used  by  all 

the  following  items,  and  is  meaningless  outside  the  file.  Local  layer  numbers  arc  unique 
but  arc  not  guaranteed  to  be  contiguous  or  monotonically  increasing. 

Name:  the  ASCII  name  of  the  layer,  converted  to  all  upper  case.  No  blanks  arc  allowed  in  the 

name. 

Options:  a  sequence  of  characters  encoding  the  options  setting  for  the  layer;  all  characters  arc  upper 

case.  If  an  option  is  ON,  the  corresponding  character  is  present.  The  current  set  of 
characters  is:  R  (the  layer  is  Readable),  W  (the  layer  is  Writable),  and  O  (the  layer  will  be 
output  when  the  drawing  is  written  to  a  file).  For  example,  RO  means  that  the  layer  can  be 
displayed  and  output  but  cannot  be  altered. 


8.  Marks  Information 


Marks  provide  a  convenient  mechanism  to  position  a  drawing  around  meaningful  reference  points,  l-lach 
mark  has  a  number  associated  with  it;  this  number  is  currently  unused  (see  Giuse  [3J  lor  more  details  on 
marks). 

The  format  of  a  mark  entry  is  the  following: 

SpageMark  x  y  number 


x.  y: 

number: 


position  of  the  mark,  in  absolute  coordinates, 
a  unique  integer  associated  with  the  mark  (currently  unused). 
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9.  Grids  Information 

'lliis  section  contains  information  about  the  mouse  and  display  grid  sellings  dial  were  in  use  when  the 
drawing  was  created.  This  information  is  not  needed  for  die  correct  interpretation  of  the  drawing,  and  is  only 
provided  as  a  convenience  to  die  user,  it  is  often  die  ease  that  a  drawing  is  edited  using  a  non-standard  grid, 
causing  potential  alignment  problems  if  a  different  grid  is  used  during  subsequent  editing. 

When  the  Reader  encounters  the  Grids  Information  section,  it  sets  die  o  rent  mouse  and  display  grids  to 
match  the  ones  specified  in  the  drawing. 

'Hie  format  of  the  grid  entry  is  the  following: 

Sgrlds  mouse- grid  display  grid 

mouse-grid:  value  of  the  mouse  grid,  as  a  posidvc  integer.  'ITiis  indicates  the  distance  between  the  two 

nearest  points  at  which  die  mouse  can  be  located. 

display-grid:  value  of  die  display  grid,  as  a  positive  integer,  ’litis  indicates  the  distance  between  points 

of  the  grid  that  OP  uses  to  facilitate  item  alignment 

Note  that  only  one  grid  entry  is  present  in  a  DP  file,  even  though  many  mouse  grids  can  be  used  during  a  DP 
editing  session.  Only  the  current  mouse  grid  is  saved  in  the  file. 
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10.  Symbol  Definitions 

Symbol  definitions  arc  collections  of  items  enclosed  by  a  begin-end  pair  and  identified  by  a  unique  name. 
Symbol  definitions  describe  bow  to  draw  symbol  instances  and  can  be  ihougln  of  as  templates;  similar 
pictures  can  be  generated  from  the  same  template  (symbol  definition)  by  scaling,  rotating,  or  mirroring  the 
basic  definition. 

Coordinates  within  definitions  arc  relative,  i.c.,  they  need  a  translation  before  they  can  be  displayed;  the 
translation  is  specified  at  the  time  the  symbol  is  instantiated.  Coordinates  within  a  symbol  definition  arc 
stored  so  that  the  center  of  the  symbol  is  the  point  (0, 0):  the  "center  of  the  symbol"  is  defined  as  the  center  of 
the  bounding  box  of  the  symbol.  In  other  words,  all  the  items  appearing  in  symbol  definitions  arc  centered 
around  the  point  (0, 0). 

10.1  Beginning  of  Symbol  Definition 

This  line  starts  the  definition  of  a  new  symbol.  The  format  of  the  line  is  the  following: 

0  width  height  name 

width,  height:  width  and  height  of  the  bounding  box  of  the  symbol  in  its  non-transformed  definition,  i.e., 

when  the  rotation  is  0  and  the  scaling  is  1.0, 1.0. 

name:  the  unique  name  of  the  symbol,  in  upper-case  characters.  This  name  is  the  only  way  this 

symbol  can  be  referred  to  in  the  future. 

After  this  line  the  primitive  elements  that  constitute  the  body  of  the  symbol  definition  are  listed,  each  one  in 
its  normal  format  (see  section  11).  Every  basic  element  can  appear  here,  including  instances  of  other  symbols; 
symbols  may  be  nested  at  any  level.  The  end  of  the  symbol  is  marked  by  the  End  of  Symbol  Definition. 

10.2  End  of  Symbol  Definition 

The  format  of  this  line  is  the  following: 

F 

This  line  marks  the  end  of  a  symbol  definition.  The  symbol  being  defined  is  closed  and  entered  in  the  list  of 
definitions.  This  line  will  typically  be  followed  by  either  the  beginning  of  a  new  definition,  or  by  the  first 
top-level  item  in  the  drawing. 


11.  Top-level  Items 


By  default,  all  items  that  arc  not  part  of  a  symbol  definition  arc  considered  to  be  at  the  top  level  of  the 
drawing.  All  top-level  items  use  absolute  coordinates,  unlike  items  that  arc  part  of  a  symbol  definition. 

Several  fields  arc  common  to  various  item  types;  their  meaning  is  described  only  once  and  will  not  be 
repeated  for  individual  items.  The  common  fields  are: 

Thickness:  a  positive  integer  diat  indicates  the  thickness  of  lines,  circles,  ellipses,  and  splines.  By 

convention,  die  thinnest  item  has  thickness  1;  in  die  current  implementation,  the  diickest 
item  has  thickness  7.  Numbers  greater  than  7  are  currently  interpreted  as  7. 

Color;  a  positive  integer  that  specifics  die  color  of  an  item.  By  convention,  color  1  indicates  a 

black  item.  Colors  tidier  dian  1  arc  preserved  and  used  for  devices  that  support  colois;s  in 
the  current  implcmcntadon  all  items  except  Polygons  arc  displayed  in  black  on  the  Perq, 
regardless  of  the  color  specified  in  die  file.  The  meaning  of  the  color  information  is  likely  to 
change  in  future  versions. 

Layer:  a  local  layer  number,  i.e.,  a  reference  to  an  ©layer  statement  This  indicates  what  layer  the 

item  belongs  to.  In  the  case  of  a  symbol  instance,  this  is  the  layer  of  the  instance,  and  may 
act  as  a  filter  for  nested  items. 

Line-Style:  a  small  integer  that  determines  the  line  style  to  be  used  for  lines,  circles,  ellipses,  and 

splines.  The  default  line  style  is  solid  and  is  indicated  by  line-style  0.  Line-style  1  indicates 
dotted ;  which  is  a  pattern  of  equally  spaced  short  dashes.  Line  style  2  indicates  dashed 
which  is  a  pattern  of  equally  spaced  long  dashes.  Line  style  3  indicates  dot-and-dash ,  which 
is  a  repeating  pattern  of  short  and  long  dashes.  Line  styles  greater  than  3  arc  currently 
undefined. 

The  following  sections  contain  the  description  of  all  the  different  types  of  items  and  the  format  of  the 
corresponding  entries  in  a  DP  file.  Remember  that  all  numbers  arc  integers,  unless  otherwise  specified. 

11.1  Straight  Lines 

L  xl  yl  x 2  y2  thickness  color  layer  line-style  ' 

xl,yl :  coordinates  of  the  first  endpoint  of  the  line. 

x2,y2:  coordinates  of  the  second  endpoint  of  the  line. 

11.2  ASCII  Strings 

S  xl  yl  x2  y2  font  color  layer  string 

xl,yl:  coordinates  of  the  lower-left  comer  of  the  bounding  box  of  the  string. 

x2,y2:  coordinates  of  the  upper-right  comer  of  the  bounding  box  of  the  string, 

font:  the  local  font  number  for  this  string.  This  number  must  match  one  of  those  defined  in  the 

section  on  fonts  (section  6). 

string:  the  actual  text  string,  truncated  to  80  characters  and  terminated  by  the  end  of  the  line. 


^Currently  the  HP  7221A  Plotter  is  the  only  device  that  supports  colors. 


The  size  of  a  string  is  computed  under  the  assumption  that  die  specified  font  is  used  to  display  the  string; 
using  a  different  font  would  result  in  a  different  size.  The  reference  point  is.  at  any  rate,  the  lower-left  corner 
of  the  string:  the  upper-right  point  can  always  be  computed  from  the  lower-left  corner.  If  a  different  font 
must  be  used  for  a  different  device,  die  string  should  be  positioned  in  such  a  way  that  its  lower-left  corner 
ends  up  at  the  point  (jr /,  yl). 


1 1 .3  Arcs  and  Circles 

A  xy  radius  an  file  I  anglc2  thickness  color  layer  line-style 

x,y:  coordinates  of  the  center  of  the  circle, 

radius:  radius  of  the  circle. 

anglcl:  first  angle  of  the  arc,  i.c.,  first  angle  encountered  on  the  arc  when  scanning  it 

counterclockwise;  the  starting  point  is  on  the  positive  X  axis,  at  ( radius ,  0)  from  the  center. 
The  angle  follows  the  usual  convention  explained  in  section  4.1. 
anglc2:  second  angle  of  the  arc.  If  anglc2  is  equal  to  anglcl  the  arc  is  a  full  circle. 

Note  that  a  full  circle  is  normally  indicated  by  anglcl  =  0,  and  angle2  =  21600. 


11.4  Ellipses 

E  xy  radius 1  radius2  angle!  angle2  thickness  color  layer  line-style 

x,y:  coordinates  of  the  center  of  the  ellipse. 

radiusl:  horizontal  radius  of  the  ellipse,  i.e.,  half  die  horizontal  diameter. 

radius2:  vertical  radius  of  the  ellipse.  , 

anglel:  first  angle  of  the  arc  of  ellipse,  i.e.,  first  angle  encountered  on  the  arc  when  scanning  it 

counterclockwise;  the  starting  point  is  on  the  positive  X  axis,  at  ( radius! ,  0)  from  the  center. 
The  angle  follows  the  usual  convention  explained  in  section  4.1. 
angle2;  second  angle  of  the  arc;  same  conventions  as  before.  If  anglc2  is  equal  to  anglcl  the  arc  is  a 

full  ellipse. 

A  full  ellipse  is  normally  indicated  by  anglel  =  0.  and  angle2  =  21600.  Note  that  this  representation  does 
not  allow  an  ellipse  whose  major  and  minor  axes  are  not  parallel  to  the  cartesian  axes,  but  such  an  ellipse  can 
be  represented  by  nesting  it  into  a  symbol  and  then  rotating  the  symbol. 

11.5  Splines 

B  xy  n  k  thickness  color  layer  line-style  xl  yl  x2 y2 ...  xn yn 

x,y:  global  offset  of  the  spline, 

n:  number  of  control  points  in  the  spline. 

k:  degree  of  the  spline;  always  equal  to  3  for  3rd  order  B-splines,  which  is  the  default  in  DP. 

Other  types  of  splines  are  not  completely  supported  for  the  lime  being  and  are  not 
documented  here. 

xl.yl:  coordinates  of  the  first  control  point,  relative  to  (x.y). 

x2,y2:  coordinates  of  the  second  control  point,  relative  to  (x.y). 


xn,yn: 


coordinates  of  the  last  control  point. 


1 1 .6  Polygons 


By  convention,  an  n-sided  polygon  is  represented  by  n  vertices:  the  first  and  last  vertices  arc  considered 
connected. 

Y  xy  thickness  color  layer  xl  yl  x2 y2 ...  xn  yn 
x,y:  global  offset  of  live  polygon. 

color:  this  parameter  is  used  to  select  a  pattern  that  fills  the  polygon.  Polygon  patterns  arc 

predefined  and  arc  intended  to  emulate  different  shades  of  gray.  Only  colors  in  die  range  1 
through  17  arc  supported:  color  1  corresponds  to  solid  black,  color  17  is  solid  white. 
Numbers  in  between  represent  intermediate  shades  of  gray,  color  8  being  an  intermediate 
"solid”  gray. 

xl.yl:  coordinates  of  the  first  vertex  of  the  polygon,  relative  to  (x.y). 

x2,y2:  coordinates  of  the  second  vertex,  relative  to  (x.y). 

xn,yn:  coordinates  of  the  last  vertex  of  the  polygon,  relative  to  (x.y). 

Note  that  the  thickness  parameter  is  ignored. 


11.7  Pins 

P  xl  yl  number  position  color  layer 

xl.yl:  abscissa  and  ordinate  of  the  pin. 

number:  an  integer  corresponding  to  the  pin  number. 

position:  an  integer  in  the  range  0  through  3  that  specifics  die  quadrant  the  pin  number  should  be 

displayed  in.6  Position  0  corresponds  to  the  first  (upper-right)  quadrant,  position  1 
corresponds  to  the  upper-left  quadrant,  and  so  on. 

Pin  numbers  are  ignored  by  many  programs  that  process  DP  drawings.  A  pin  contained  in  a  symbol  acts  as  a 
gravity  point  in  DP,  independent  of  its  pin  number. 

1 1 .8  Instance  of  a  Symbol 

This  line  creates  an  instance  of  a  symbol.  Instantiating  a  symbol  is  equivalent  to  calling  a  procedure  that  has 
been  defined  and  stored  away.  The  instance  specifies  the  global  offset  and  transformations  for  the  symbol; 
the  transformations  are  applied  first,  and  the  offset  is  applied  later.  If  nested  symbols  arc  contained  in  the 
definition,  each  offset/transformation  is  applied  in  order,  from  the  innermost  to  the  outermost  levels. 

Transformations  are  additive:  if  a  symbol  has  rotation  RI  and  calls  another  symbol  with  rotation  R2,  the  final 
result  is  the  same  as  if  the  nested  symbol  were  directly  called  with  rotation  (R1  +  R2).  The  order  of 
application  of  transformations  is  generally  irrelevant,  with  one  exception:  when  a  symbol  is  non-uniformly 
scaled  in  the  horizontal  direction,  this  scaling  should  be  applied  before  the  rotation.  This  ensures  that  the 
shape  of  the  symbol  docs  not  change  for  different  rotations. 


^Even  if  this  is  not  an  angle,  it  is  used  as  such  when  the  pin  appears  inside  a  transformed  symbol. 


The  format  of  a  symbol  instance  is  the  following: 
C  x  y  angle  scale-. x  scale- y  layer  name 


x,y:  abscissa  and  ordinate  of  the  center  of  the  symbol,  i.e.,  global  offset 

angle:  rotation  of  die  instance  (sec  4.1  for  angles  conventions). 

scalc-x,scale-y:  (these  arc  two  real  numbers):  scaling  factors  for  the  instance  in  the  X  and  Y  directions.  A 

scaling  factor  of  1.0  means  the  same  scale  as  the  definition;  a  negative  factor  implies  a 
mirroring  operation.  Note  that  because  of  the  order  of  application  of  symbol 
transformations,  these  factors  indicate  the  scaling  of  the  symbol  before  die  rotation  is 
applied,  i.e.,  dicy  indicate  the  scaling  factors  relative  to  the  symbol's  own  X  and  Y  axes, 
name:  reference  to  a  symbol  definition.  This  string  must  match  exactly  die  name  in  a  symbol 

definition,  and  thus  it  must  be  in  all  upper-ease  characters.  The  symbol  must  be  already 
defined;  forward  references  arc  not  allowed. 


12.  BNF  Description  of  the  Format 


Ihis  is  the  description  of  the  format  of  DP  drawing  files  in  an  extended  UNF  syntax.  The  following 
additional  notations  have  been  used: 

{  <itcm>  }+  <itcm>  may  appear  from  1  to  infinite  times. 

{  <itcm>  }  <itcm>  may  appear  any  number  of  times,  including  0. 

<char>,  not  defined  here,  is  essentially  the  whole  ASCII  printing  set  minus  KOI.  (Hnd-Of-Line). 

<DP  file>  ::  =  DP  vcr."  <string>  {<line>}* 

<commcnt>  ::=  {<char>}*  EOL 

<string>  ::=  {<char>}*  EOL 

<number>  ::  =  ”  "  <intcgcr>  |  "  <intcger> 

<intcger>  ::=  {<digit>}+ 

<rcal>  ::  =  <number>  <intcgcr>  |  <number> 

<digit>  ::=  0 1 1 1 2 1 3  1 4 1 5  1 6 1 7  |  8  1 9 

<point>  ::=  <numbcr>  <number> 

<parameters>  ::  =  <numbcr>  <number>  <number>  <number> 

<line>  ::  =  <symbol  definition>  |  <ENV  Iine>  |  <DP  line> 

<ENV  line>  ::  =  "@font"  <number>  {<char>}  +  <number>  <number>  <string>  | 

"@perqFont"  <number>  <string>  |  "©layer"  <number>  {<char>}  +  <string>  | 
”@pageMark"  <number>  <number>  <number>  EOL  J 
"©grids"  <number>  <number>  EOL 

<DP  line>  ::  =  "L"  <point>  <point>  <parameters>  EOL  | 

"A"  <point>  <number>  <number>  <number>  <parameters>  EOL  | 

”E"  <point>  <number>  <number>  <number>  <numbcr>  <parametcrs>  EOL  | 

"B"  <point>  <number>  <numbcr>  <paramctcrs>  {<point>}+  EOL| 

"Y"  <point>  <number>  <number>  <number>  {<point>}+  EOL| 

"S"  <point>  <point>  <number>  <number>  <numbcr>  <string>  | 

"P"  <point>  <number>  <number>  <numbcr>  <number>  EOL  | 

"C”  <point>  <numbcr>  <rcal>  <real>  <number>  <string>  | 

<comment> 

<symbol  definition>  ::  =  "D”  <number>  <number>  <string> 

{<DPline>}  + 

”F'  EOL 


13.  Example  of  a  Drawing  File 


The  present  section  contains  an  example  of  an  actual  drawing  file.  The  drawing  in  the  example  is  shown  in 
fig.  13-1. 


The  complete  text  of  the  DP  file  is  also  shown.  Several  points  are  worth  discussing: 

•  Most  of  the  drawing  is  on  the  STANDARD  layer,  except  for  the  axes  system  in  the  graph  at  the 
right  which  is  on  the  FRAME  layer  instead.  This  layer  includes  the  two  axes  and  the  two  strings 
"Y  Axis"  and  "X  Axis";  the  layer  is  currently  non-writablc,  as  indicated  by  the  absence  of  the  W 
parameter  from  the  last  field  of  the  line  "©layer  2  FRAME  RO”. 

•  Two  instances  of  the  symbol  named  PICTURE  are  used;  the  two  instances  appear  in  the  left  half 
of  the  drawing.  The  instance  at  the  bottom  is  scaled  down  (the  scaling  parameters  are  equal  to 
0.75  and  0.75)  and  rotated  180  degrees  counterclockwise  (as  indicated  by  a  rotation  angle  of  10800 
minutes). 

•  The  symbol  PICTURE  is  composed  of  two  instances  of  the  symbol  RECT,  one  instance  of  the 
symbol  TRIANGLE,  one  instance  of  the  symbol  COMPOSITE,  four  straight  dotted  lines  (hav  ing 
line-style  1),  and  four  straight  lines  that  describe  the  box  around  the  picture.  The  four  lines  have 
thickness  3  and  line-style  0,  i.e.,  they  are  solid. 

•  The  symbol  RECT  consists  of  four  straight  solid  lines  (having  thickness  1)  and  of  the  string  "Rl". 
This  string  is  drawn  in  font  Gacha  7  Roman,  as  indicated  by  the  font  number  (1)  which  points  to 
the  definition  line  "©font  I  r  7  0  Gacha". 


*  The  graph  at  the  bottom-right  ts  drawn  as  a  single  3rd-ordcr  B-splinc.  described  by  uic  line 
B  2  -168  6  3  1  1  1  0  311  1  204  0  108  112  24  6  0  218 
The  spline  is  defined  by  llic  5  control  points  (31 U)  (204,0)  ( 108,1 12)  (24,6)  (0,218)  and  is  drawn 
in  thickness  1. 

DPvcr.  6.10 
09-Jul-85  12:54:17 
SYMBOL:  7404 
CALLS: 

SYMBOL:  PICTURE 

CALLS:  COMPOS!  LI-  RECT TRIANGLE 

SYMBOL:  COMPOSITE 

CALLS:  RECT  TRIANGLE 

SYMBOL:  TRIANGLE 

CALLS: 

SYMBOL:  RECT 
CALLS: 

©font  1  r  7  0  Gacha 
©pcrqFont  1  gacha7.kst 
©'font  4  r  12  0  TimesRoman 
©  pcrqFont  4  gacha7.kst 
©layer  1  STANDARD  RWO 
©layer  2  FRAME  RO 
©pageMark  41  -121 1 
©pageMark  -18  7  3 
©pageMark  41  -121  2 
©grids  1 6 
D  30  48  RECT 
S -7 -18  5 -91  1  1R1 
L  15  -24  15  24  1  1  1 0 
L  15  -24-15  -24  1  1  10 
L -15  -24 -15  24  1  1  10 
L  15  24  -15  24  1  1  1 0 
F 

D  36  78  TRIANGLE 
L  18  39  6  -39  1  1  1  0 
L  6  -39  -18  -15  1 1  1  0 
L  -18  -15  18  39  1  1  1 0 
F 

D  96  80  COMPOSITE 
C  8  0  18900  1  1  1  TRIANGLE 
C  -33  -8  0  1  1  1  RECT 
F 

D231  179  PICTURE 
C  24  -57  0  3.13844  1  1  RECT 
L  108  75  -30  75  1  1  1  1 
L  -30  -22  -30  75  1  1  1  1 
L  108  -22  -30  -22  1  1  1  1 
L  108  -22  108  75  1  1  1  1 
L  11681  -115  81  3  1  10 


1-115  -89  -115  81  3  1  1  0 
1. 116-89-115-89  3  1  10 
1.116  89  116  81  3  1  1  0 
C  -84  -57  0  1  1  1  RKCT 
C  -82  34  0  1  l  1  TRIANGLE 
C  29  50  0  1  1  t  COMPOSITE 
F 

13  45  24  7404 
S -22  2 -16  11  1  1  1  A 
P-1501  1  1 1 
S  17  1  23  10  1  1  l  Y 
A  110  3  9900  9150  1 1  10 
1  -15  -12  8  0  1  1  10 
L -15  12  -15  -121110 
I. -15  12801  1  10 
P  14  0  2  4  1 1 
F 

C  -223  99  0  1  1  1  PICTURE 
A  248  118  44  5400  20056  1  1  10 
L  189  174  189  61  1  1 1 0 
L  295  98  248  118  1  110 
L248  170248  118  1  1  10 
L  306  174  30661  1  110 
L  306  174  189  174  1  1  1  0 
L  306  61  189  61  1  1  1 0 
A  248  118  52  0  21600  3  1  10 
C  7  131  0  1  1  1  7404 
L  55  131  21  1311110 
C  70  131  01  1  17404 
L  84  131 117  1311110 
L-9  131-511311110 
L  37  173  37  131  1  1  1 0 
C  70  173  0  1  1  1  7404 
L  55  173  37  173  1  1  1 0 
L  84  173  117  173  1  1  10 

B  2  -168  5  3  1  1  1  0  311  l  204  0  108  112  24  6  0  218 
C  -223  -89  10800  0.75  0.75  1  PICTURE 
L  -4  64  -4  -167  1  12  0 
L  338  -167  -4  -167  1  1  2  0 
L  3  57  -4  64  1  1  2  0 
L -12  57-4  64  1  120 
S  26  31  62  40  4  1  2  Y  Axis 
L  323 -171  338-167  1  1  20 
L  323  -164  338  -167  1  1  2  0 
S  280  -189  316  -180  4  ]  2  X  Axis 
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14.  Compatibility  with  Previous  Versions 

The  present  document  describes  die  format  of  1)1*  files  for  internal  purposes  only;  no  guarantee  is  implied  as 
to  the  stability  of  die  format  itself.  Although  die  format  has  remained  substantially  unchanged  for  long 
periods  **f  time,  changes  and  extensions  to  DP  have  required  various  adaptations  and  additions  to  die  format. 

In  particular,  it  should  be  noted  that  changes  and  extensions  may  make  new  formats  unreadable  by  older 
versions  of  DP.  It  is  typically  impossible  to  read  files  whose  version  number  is  higher  (newer)  than  die 
version  of  DP  one  is  using.  'Ihc  DP  Reader,  on  die  other  hand,  is  written  in  such  a  way  as  to  be  compatible 
with  older  versions;  all  versions  of  DP  can  read  files  whose  version  number  is  less  than  or  equal  to  die 
particular  version  being  used. 

This  is  believed  to  apply  to  all  existing  versions  of  die  program,  including  local  modifications  dial  you  may  be 
using.  If  this  is  not  the  ease,  please  contact  the  author  reporting  the  version  number  of  the  instance  of  DP  you 
arc  using,  the  version  number  and  creation  date  of  the  drawing  file,  and  information  about  how  you  obtained 
your  version  of  the  program. 
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